From: Owen Taylor <otaylor@src.gnome.org>
Date: Fri, 31 Oct 2008 18:24:29 +0000 (+0000)
Subject: Add annotations to fix return-value transfer for shell_global_get()
X-Git-Tag: archive/raspbian/50.5-1+rpi1~1^2~1013^2^2~11628
X-Git-Url: https://dgit.raspbian.org/%22http://www.example.com/cgi/%22/%22http:/www.example.com/cgi/%22?a=commitdiff_plain;h=9c4d104630ceffe8a24b7e6007ba8f71ee91e123;p=gnome-shell.git

Add annotations to fix return-value transfer for shell_global_get()

Default transfership for a GObject return value is 'full', override
it to 'none' for a singleton getter.

svn path=/trunk/; revision=12
---

diff --git a/src/shell-global.c b/src/shell-global.c
index c095b42ad..975b4f528 100644
--- a/src/shell-global.c
+++ b/src/shell-global.c
@@ -119,6 +119,13 @@ shell_global_class_init (ShellGlobalClass *klass)
                                                         G_PARAM_READABLE));
 }
 
+/**
+ * shell_global_get:
+ *
+ * Gets the singleton global object that represents the desktop.
+ *
+ * Return value: (transfer none): the singleton global object
+ */
 ShellGlobal *
 shell_global_get (void)
 {
@@ -130,6 +137,16 @@ shell_global_get (void)
   return the_object;
 }
 
+/**
+ * shell_global_set_stage_input_area:
+ * x: X coordinate of rectangle
+ * y: X coordinate of rectangle
+ * width: width of rectangle
+ * height: Height of rectangle
+ *
+ * Sets the area of the stage that is responsive to mouse clicks as
+ * a rectangle.
+ */
 void
 shell_global_set_stage_input_area (ShellGlobal *global,
                                    int          x,